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; NMLDEF.MDL - internal definitions for NML 
Version ‘v04-000' 


MPARAAAALALAAAAAAL AAA LLL ELLA EASES ESSERE EERE EERE ETERS ESSER CSTE ESS eee ea 


COPYRIGHT (c) 1978, 1980, 1982, 1984 BY 
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
ALL RIGHTS RESERVED. 


be ie 
:* ® 
® * 
J *® 
* ® 
* THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED * 
* ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE 
* INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER + 
is COPIES THEREOF MAY NOT BE P ROVIDED OR OTHERWISE MADE AVAILABLE TO ANY 
:® OTHER PERSON, ITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
:@ TRANSFERRED. “ 
** * 
¢* THE INFORMATION IN THIS SOFTWARE 1S SUBJECT TO CHANGE WITHOUT NOTICE + 
;* AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT * 
:* CORPORATION. . 
** z 
-* ® 
*® ® 
:* *® 
* « 
:@ ® 


DIGITAL ASSUMES NO RESPONS 
SOFTWARE ON EQUIPMENT WHIC 


ITY FOR THE USE OR RELIABILITY OF ITS 


IBILITY 
H IS NOT SUPPLIED BY DIGITAL. 


Se Se Oe Se Ge Ge Ge Ge Se Ge Se Se Se Se Se Se Se Se Se Se Ge Fe Se Ge ee 


PARARASLALAAALALALA ALLEL ALE LEAL AAAS EEE E ERATE EERE RSET EERE RSE E SERS S ERAS REE SS 


+ 
+ 


FACILITY: VAX/VMS DECnet Network Management Listener 


four ISAM keys. 


v03-008 MKP0013 Kathy Pecks 8-May-1983 


Coordinate NML$LOG bits in NML and MOM. 


: ABSTRACT: 

; This file contains varions MDL definitions for NML. 
: ENVIRONMENT: 

: n/a 

; AUTHOR: Scott Davidson CREATION DATE: 1-Aug-1979 
$ MODIFICATION HISTORY: 

; v03-011 MKP0016 Kathy Perko 25_Mar-1984 
: d node parameter parsing constants. 

; v03-010 mKPOO1S athy Perko 6-Jan-1984 
; Add X25 Access Module entity. 

: V03-009 MKP0014 Kathy Perko 7=July-1983 
3 Add definitions for {san node pernenent database with 


NMLDEF .MDL; 1 


Be Se Se Se Se Se Se Ge Ge Be Be Ge Se Fe GY Se Ge Se Se Se Se Fe Se Ss Se Se Se Se Se Se BFS Se SF Ss Se Ss Se Se Oe SHES Se Se Sees 


v03-007 MKP0012 kecky Perko tie (bo mye 
Delete service functions from N Also, ad 
support for circuit service S Roties and P= 
physical address. 


V03-006 MKP0011 Kathy Perko 17-Jan-1983 
Support for NI tent thurater Module. 
v03-005 MKP0010 Kathy Perko 18-Nov-1982 


Add module as a source for logging events. 
Add Phase IV. 


V03-004 MKP0009 Kathy Perko 27-Sept-1982 
Add Area and rit entities. 


v03-003 MKP0008 21-Sept-1982 
Add dispatch er ee rinitions for ZERO. 


v03-002 MKPO007_ Kathy Perko 22-June-1982 
Set up ‘active network’ for X-25 Protocol networks and 
enhance Entity Table (in NMLDAT) to include ACTIVE and 
e 


KNOWN search key IDs, lengths, values, and operators. 
Add X29-Server entity. 
v03-001 MKP0006 Kathy Perko 17-Mar-1982 


Add NML entity codes and permanent database keys for 
X-25 Access and Server Modules. 


v02-006 MKP0005 Kathy Perko 20-Nov-1981 
Add pereneter poets flags for X.25 Protocol DTEs, 
e 


Groups, and wor 
v02-005 MKP0004 Kathy Perko 17-Nov-1981 

Add circuits to event source block definitions. 
v02-004 MKP0003 Kathy Perko 3-Nov-1981 


Add field to MSB for’ second Line of message text 
for RMS signalled messages. 


v02-003 MKP0002 Kathy Perko 14-0c¢ t-1981 
Add flags for parsing V2 to V3 SET LINE conversions. 
v02-002 MKP0001 Kathy Perko 18-Sept-1981 


Change network menagenent version number to 3.0.0 
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; Symbol definitions for the Network Management Listener 


SSTRUCT NML 
3 Message parsing flag bit definitions (set in NMLSGL_PRS_FLGS) 


Common parsing flags. 


ee eees 


<M 
PRS_VMS ; VMS specific function 
PRS_ALL 3; Set/clear all parameters 
PRS_QUALIFIER 3; NICE command includes a qualifier 
PRS_ENTITY_FOUND ; On multiple este operations, at least one 
' 3 entity has been set, shown, etc. 


; Specific entity parsing flags. 


: Node parsing flags. 


ie 
8 
PRS_EXEPG 3; Executor-only parameter group 
PRS_NODPG ; Executor/node parameter group 
PRS_REMPG ; Remote node parameter group 
: PRS_LOCPG ; Loop node parameter group 
: Logging parsing flags. 
v<" : 
PRS_EXESNK 3; Sink node is executor 
PRS_SNKNOD 3; Sink node specified 
PRS_KNOSNK ; Known sink nodes 
PRS_EFIPG >; Event filter parameter group 
PRS_ESIPG ; Event sink parameter group 
‘ RS_EVE ; Event parameter processed 
: Line parsing flags. 
v<m . 
PRS_LINE,6 ; Line flags (LINS definitions) 
PRS_V _LINE 3; Command parameters are for a Line. 
PRS_Vé2_CIRCUIT 3; Command parameters are for a circuit. 
. PRS_V2_STA ; Command contains a state change. 


> NICE message parsing constants 


NMLDEF .MDL; 1 


bc 
sd Er PARAM, 
wOD ~1D_PARAM, 


; Protocol DTE parsing 


v<m 
PRS_CHANNELS 
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; Parameter is always a node number 
; Parameter can be a node number or name 


flags. 


; Processing SET channels - first channel 
3 pair already encountered. 
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: Network Management version definitions for message handling 
; (Set in NMLSGB_CMD_VER) 


ants 1 Phase II function 
PHASES_OR_4, 2 ; Phase II] or IV function 


: NML return codes 


t<,$ 
STS_suc, 1 ; Success 
STS_FUN, ~1* 3 radi gf ne function or option 
STS_INV, =$% : Invalid message format 
STS_PRI, -5* ; Privilege violation 
STS_SIZ, ~4* ; Message too long 
STS_MPR, “25 ; Network management program error 
STS_PTY, -6* ; Unrecognized parameter type 
STS_MVE, =h3s : Incompatible management version 
STS_CMP, -8* 3 parecoan) zee component 
STS_IDE, -9*2 : Invalid identification format 
STS_LCO, =19%8 ; Line communication error 
STS_STA, =11* ; Component in wrong state 
STS_FOP, -13*2 : File open error 
STS_FCO, -1482 : Invalid file contents 
STS_RES, =1286 ; Resource error 
STS_PVA, -16* 3; Invalid parameter value 
STS_LPR, -17*2 ; Line protocol error 
STS_FIO, -18*2 ; File i/o error 
STS_MLD, -19*2 ; Mirror Link disconnected 
STS_ROO, -20*2 : No room for new entry 
STS_MCF, “$38 ; Mirror connect failed 
STS_PNA, = ¢: ; Parameter not applicable 
STS_PLO, -23* ; Parameter value too long 
STS_HAR, -24%2 ; Hardware failure 
STS_OPE, = 236 ; Operation failure 
STS_SYS, -26* : System-specific network management function not supported 
STS_PGP, “$85 : Invalid parameter grouping 
STS_BLR, = He ; Bad loopback response 
STS_PMS, -29* ; Parameter missing 


> 

3; Network Management parameters 

K < 
VERSION, 4 : Network Management version 
DEC_ECO, 0 ; DIGITAL ECO number 
USER_ECO, ; User ECO number 
FAC_CODE, 505 z Facility code 
SIG_CODE, 505*65536 3 Signal code (505°16) 

> 


; Data definitions 
K< 
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; Special permanent 


t< 


KEY_LINE, =1 
KEY_SINK, =2 


KEY_EXE, <-3 
KEY_CIR, =4 


data base 


KEY_NET, -5 

KEY_X25_SERV,  <-6 

KEY_X 9 SER ° -7 

KEY_ -8 

KEY_NI_CONFG -9 
E KEY-X25_ACCESS, -10 
: Internal entit 


t< 


LINE 

LOGGING 

SINK 

NODE 

NODEBYNAME 
LOOPNODE 
ADJACENT _NODE 
EXECUTOR 

OBJECT 

CIRCUIT 
CIRCUIT_ADJACENT 
CIRCUIT_ADJ_SRV 


X25_ACCESS 
PROT_NET 


id codes, 


Sete Ge Ge Ge Ge Ge Ge Ge Ge Ge Ge 
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String 


record search key parameter codes. 


Line 

Logging sink 

Node uses name or address 
Executor node 

Object uses name 

Circui 


t 
; Protocol Module Network 


X25-Server Module 
X29-Server Module 
X25-Trace Module 

NI Configurator Module 
X25 Access Module Network 


Do not reorder. Entries in 
>; NMLSAB_ENTITYDATA te” .e depend on this order. 


poet 
oggin 
Logging sink 
Node (by address) 
Wode by name 
Loop node (by name anty’ 
Nodes one hop away, volatile 
database only 

Executor node (by address=0) 

bject 
Circuit 
By circuit, Nodes one hop away, 

volatile database only. 

By circuit, service adjacencies 
Area, volatile database only. 
“Access Module 
5-Protocol Module Networks 
-Protocol Module DTEs 
-Protocol Module Groups 
“Server Module 
-Server Module Destination 
-Trace Module 
“Trace Module Trecepoint 
-Server Module 

“Server Module Destination 
I Configurator Module 


2 2 + ff tt. 2. ¢.7.) 
ODOVWMAMVIUVIVIVIVI 


§: 


NMLDEF 


ic 


-MDL;1 


LINKS 
PROTOCOL 


MAXENTITY 
SUMMARY 

STATUS 
CHARACTERISTICS 
COUNTERS 


ZERO 
SERVICE 
MAXINFO 


; Logical Links, volatile database only. 


; Protocol Module 
; Maximum entity number 


: Internal information table index codes. 


Zero counters 
Service parameters 


: Summary (NMASC_INF 
; Status (NMASC_INF 
; Characteristics bear +28 
; Counters (NMASC_INF 
; Events (NMASC_INF 


; Maximum information type 


1 
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Network Management Node database definitions. Y 


; d for manipulating 
; the node permanent database. This database (unlike t 


se 
ike the other entity 
; permanent databases) uses 4 ISAM keys. 


$STRUCT NMN 
F KEY_LIS.L ; 3rd alternate key = List node (consists of node 

; eelig « key concatenated with node 
: e key 

KEY_ADD,0,W ; Primar "Tey in record = node address 

KEY_TYP,2,W ; Ist alternate key in record = node type (executor, 
3 remote, or loopnode). 

KEY_NAM,T,6 3; 2nd alternate key in record = node name 

NODE_KEYS_LEN ; Length of all three keys. 

NOD_PARAMS ,A ; Beginning of node's NICE parameters 
: in the record. 

< 


: Keys for accessing node permanent database. 


ADD_KEY_REF, 0 ; The primary key = node address 


concatenated with node type. Used 

to LIST nodes in order by address, 

but with exec first, then remotes, and 
last loopnodes. 


TYP_KEY_REF, ; The Ist alternate key = node type 
3 nml$c_typ_exec, nml$c_typ_remote, 
3 nml$c_ftyp_Toopnode). Overlaps with 
3 node address key. 

NAM_KEY_REF, ¢ ; The end alternate key = node name 

LIS_KEY_REF, ; The 5rd alternate key = node address 


: Lengths of node permanent database keys 


ADD_KEY_LEN, 3 
TYP~KEY_LEN, 


NAM_KEY_LEN, 6 
LIS-KEY"LEN, 4 


The primary key = node address 

The first alternate key overlaps with the 
node address Rey 

The second alternate key = node name 

The third alternate key = node address 
concatenated with node type. 


Key values for node key = type. The LIST key concatenates the node 

address key with the node type key. This allows the the T 

command to get nodes by type and, within type. sequentially by node 

address. The key value is constructed with a zero for the node 

address; hence when you do a $GET of (type OR 0) with a match type 
a 


of GTR, it will get the first node of t type in the file. 
eogeens sequential reads will return the nodes of that type in 
ascending order by address. 

TYP_EXEC 0 3 type = executor node 

TYP~REMOTE 1 3; type = a remote node 

TYP~LOOPNODE , 2 3; type = a loopnode 
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; what RMS operations to perform. 


; Do a SPUT (write a new record) 
; doa SDELET fupdate an existing record) 


Do a SDELETE (delete a record) 
GET (read a record) 
| 
| 
| 


| 
; Input values to node database routines. Used for determining | 
| 


PuT_REC 1 
UPDATE REC, 


peer “REC, 
GE JREC, 4 ; Do a 
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; Message segment biock (MSB) definitions 


$sTRUCT MSB 
FLAGS,L 


CODE _FLD 
DET_FLD 
MSG"FLD 


F 
V<m 


L 
CODE. 8 
DETAIL, .W 
TEXT, L 
TEXTS, L 
ENTITY,A 


DATA,A 
LENGTH 


casas 7 Ty 
“vo Ww 


Flags 


Status code present (not used) 

Error detail field present (DETAIL) 
Message text field present (TEXT) 
Second Line of message text present ( 
Enitity descriptor field present (ENT 
Data descriptor field present (DATA) 
System message field present (TEXT) 


TEXT2) 
ITY) 


Status code 


; Detail 

; Status code for text message. 

; Status code for second Line of text msg. 
; Entity descriptor address 


Data descriptor address 
Maximum MSB size 


| 
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; NAL internal logging (debugging) flags 


; These flags are used to enable Logging of specified data to the NML log 
; file. The flags are defined by translating the logical name NMLSLOG. 


$STRUCT DBG 


C< 
NETIO 3; Network send/receive logging 
FILEIO 3; File read/write logging 
NPARSE >; NPARSE state transition tg ¢ be 
LOOPIO 3; Loopback transmit/receive logging 
ACPQIO 3 NETACP Q10 Loggin 
MOP IO ; MOP send/receive ogging 
SRVTRC 3; Trace service operations 

‘ EVENTS ; Network event (EVL) Logging 

C<,,16,1 
DMPNOD ; Dump node permanent data base file 
DMPLIN ; Dump Line permanent data base file 
DMPLOG ; Dump Logging permanent data base file 
DMPOBJ ; Dump object permanent data base file 
DMPCIR ; Dump circuit permanent data base file 
eres ; Dump X25 module permanent data base file 
DMPX29 3; Dump X29 module permanent data base file 
DMPCNF ; Dump Configurator Module permanent data base file 


NMLDEF .MDL; 1 
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; Parameter semantic table (PST) definitions 
$sTRUCT PST 


F 


cana 


DATAID,W 
FO 
DATATYPE ,B 
MINVALUE 
XVALUE , t 


NFB ol 
ENTRYLEN 


DNA parameter code 

Parameter format (byte, word, Longword. ose ) 
Data type code (coded, "ee mult ple, etc. 
Minimum value or string | 

Maximum value . string | length 

ACP parameter identif 

Parameter semantic dhe 4 entry length 


eta 
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; Entity information table definitions. 


$sTRUCT EIT 


F FILEID,B 
F DETAIL.w 

F KEY,W 

F DATABASE,B 
i SRCH_ID1,L 


SRCH_1D2,L 


Sete te Ge Ge Ge 


Permanent data base file id code 

NICE error detail entity code 

Permanent data base search key 

Volatile data base ID 

Volatile data base search key one ID for one entity 
Volatile data base search key two ID for one entity 


; SHOW KNOWN search key ID, Length, value, and operator. 


. <n 
KNO“SRCH-LENI,L_: 
KNO-SRCH VALI,L 


NO-OPERT,B 


Search key one ID 

Search key one length 

Search key one value 

Sense search one operator (EQL, NEQ, etc.) 


; SHOW ACTIVE search key ID, length, value, and operator. 


ACT_SRCH_ID1,L —; 
ACT-SRCH-LENI,L eo; 
ACT“SRCH-VAL1.L; 
ACT-OPERT,B ; 


ALLTAB,A ; 
ENTRYLEN 


cn aT 


E 


Search key one ID 

Search key one length 

Search key one value 

Sense of search one operator (EQL, NEQ, etc.) 


Parameter sable for SET ALL 


: Entry lengt 


: Change parameter table definitions. 


$sTRUCT CPT 


F PSTINDEX,W 
DEF INE RIN,A 


Parameter semantic table index 
Define routine address 

Purge routine address 

Set routine address 

Clear routine address 

Length of table entry 


1 
NMLDEF .MDL; 1 16-SEP-1984 16:39:06.48 Page 14 


; Change dispatch table definitions. This table is used by NML CHANGE or 


; NMLREAD to dispatch to the correct change routine for the entity. 
$sTRUCT DT 
f DESPATCH A, ; Dispatch routine for this entity 


: Dispatch table definitions for NICE change operations. 
F SEDE_PARSE,L Set/Define NPARSE table for parsing the 


CE command parameters 
CLPU_PARSE,L Clear/Purge NPARSE table for parsing the 
I ommand perenesere. 


C 
SET routines for en 


Sete Se Ge Ge te Sete 
Ol ee 


F 
F SET_ROUTINES,A,4 . 
F CLEAR_ROUTINES A,4 CLEAR routines for entity. 
F DEFINE ROUTINES,A,4 DEFINE routines for entity. 
F PURGE_ROUTINES,A,4 PURGE routines for entity. 
P 1 

: Dispatch table definitions for NICE read operations. 
F SHOW _ROUTINES,A,5 ; SHOW routines for entity. 
F LIST_ROUTINES,A,5 3; LIST routines for entity 


E 


' 
i 
L 


SSTRUCT CHG 
Each of the DT$ change ROUTINES fields breaks down into the following 


' 

. 1 
3; routine offsets. They are offsets in order to make NMLSHR PIC. 
f ENTITY,L 3 Offset to change routine for single entity i 
F ENTITY_W_QUAL,L 3; Offset to change routine for single entity L 

; with a qualifier 
F KNOWN,L 3; Offset to change routine for KNOWN entities. 
F KNOWN_W_QUAL ,L 3; Offset to change routine for KNOWN entities 

3 with qualifier 
L CHG_TABLEN 3; Length of dispatch table 


$SSTRUCT RD 


; Each of the DT$ read ROUTINES fields breaks down into the following 
3; routine offsets. They are offsets in order to make NMLSHR PIC. 


f ENTITY,L 3; Offset to read routine for single entity 
F ENTITY_W_QUAL,L 3; Offset to read routine for single entity 
3 with a qualifier 
F KNOWN,L 3: Offset to read routine for KNOWN entities. 
F KNOWN_W_QUAL ,L 3; Offset to read routine for KNOWN entities 


41 
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with qualifier 
L : offset to read routine for ACTIVE entities. 
EN ; Length of dispatch table 


SSTRUCT ZER 


; Each of the ZER$S zero ROUTINES fields breaks down into the Lo} towing 

; routine offsets. They are offsets in order to make NMLSHR PIC. 

f DISPATCH.L ; Dispatch routine for this en ity 

F ENTITY,L 3; Offset to zero routine tod s e entities. 
F KNOWN,L 3; Offset to zero routine for KNO N entities. 
L ZER_TABLEN : Length of dispatch table. 
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$sTRUCT 
F 
F 
F 
F 
S 
S 
S 
F 
L 
E 
: Event 
$sTRUCT 
F 
F 
F 
F 
L 
E 
: Event 
$sTRUCT 
F 
F 
F 
F 
F 
F 


SRC 
LENGTH,W 
SINKTYPE ,B 


SRCTYPE ,B 


SOURCE ,T,18 
NODADR ,O,W 


IDLENGTH,0,B 


MSKCOUNT ,W 
LENGTH 


block definitions. 
EvT 

CLASS,W 

1 


LOGMSK 
FILTERMSK,Q 
LENGTH 


table definitions. 
ETB 


CLASS,W 
GLOBAL ,A 


oA 
CIRCUIT,A 
LINE,A 
MODULE ,A 


; Event source block definitions. 
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; This file defines the event data base ures. 


Byte count of entire source block 


Sink type code: NMASC_SNK_CON 
NMASC_SNK_FIL 
NMASC_SNK_MON 


Source type code: NMASC_ENT_KNO 
NMASC_ENT_NOD 
NMASC_ENT_CIR 
NMASC_ENT_LIN 


Source id string 


Source = node (NMASC_ENT_NOD) 
Node address 
Source = Line or circuit (NMASC_ENT_LIN or 
NMASC_ENT_CIR) 


Source id string Tength 
Source id string 


Count of event blocks (mask sets) 
Length of fixed part of source block 


Event class 

Spare 

Event log mask 

Event filter mask 
Length of event block 
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L  ENTRYLEN ; Length of event table entry 
: 
: End of NMLDEF.MDL 


ENT CORPORATION 
ND PROPRIETARY 


m0280 vax7vms v4_o C * 


D=8 


